ChirpStack v4

ChirpStack v4 is the latest major version of ChirpStack LoRaWAN Network Server.

We use a standard output transformation processor that transforms output messages from Actility format to ChirpStack v4 event payloads.

All examples below show the Actility message and the transformed ChirpStack v4 message directly. On your connection, inside the "Output Stream Processors" panel, you can add an operation that do the transformation.

Uplink message

Input (Actility format)

{
  "DevEUI_uplink": {
    "Time": "2021-12-01T00:00:11.013+01:00",
    "DevEUI": "402C765000000074",
    "FPort": 2,
    "FCntUp": 53,
    "ADRbit": 1,
    "MType": 4,
    "FCntDn": 54,
    "payload_hex": "02300040a0",
    "LrrRSSI": -83.0,
    "LrrSNR": 9.5,
    "SpFact": 7,
    "Channel": "LC1",
    "Lrrid": "3C200E92",
    "LrrLAT": 48.933865,
    "LrrLON": 1.195898,
    "Lrrs": {
      "Lrr": [
        {
          "Lrrid": "3C200E92",
          "Chain": 0,
          "LrrRSSI": -83.0,
          "LrrSNR": 9.5
        },
        {
          "Lrrid": "1000027C",
          "Chain": 0,
          "LrrRSSI": -89.0,
          "LrrSNR": 6.75
        }
      ]
    },
    "CustomerData": {
      "tags": [
        "site=Paris",
        "location = Kitchen office"
      ],
      "name": "My Demo Device"
    },
    "DriverCfg": {
      "app": {
        "pId": "baumer",
        "mId": "wep5",
        "ver": "1"
      }
    },
    "Frequency": 868.1,
    "payload": {
      "type": "pressure"
    }
  }
}

Output (ChirpStack v4 format)

{
  "devEUI": "QCx2UAAAAHQ=",
  "fPort": 2,
  "deviceName": "My Demo Device",
  "fCnt": 53,
  "adr": true,
  "applicationName": "baumer:wep5:1",
  "rxInfo": [
    {
      "rssi": -83.0,
      "loRaSNR": 9.5,
      "rfChain": 0,
      "gatewayID": "PCAOkg==",
      "location": {
        "latitude": 48.933865,
        "longitude": 1.195898
      },
      "time": "2021-11-30T23:00:11.013Z"
    },
    {
      "rssi": -89.0,
      "loRaSNR": 6.75,
      "rfChain": 0,
      "gatewayID": "EAACfA=="
    }
  ],
  "data": "AjAAQKA=",
  "objectJSON": "{\"type\":\"pressure\"}",
  "tags": {
    "site": "Paris",
    "location": "Kitchen office"
  },
  "txInfo": {
    "frequency": 868100000,
    "modulation": "LORA",
    "loRaModulationInfo": {
      "spreadingFactor": 7
    }
  }
}

Downlink_Sent message

Input (Actility format)

{
  "DevEUI_downlink_Sent": {
    "Time": "2020-06-05T14:24:20.787+02:00",
    "DevEUI": "20635F0161000022",
    "FPort": 2,
    "FCntDn": 24,
    "FCntUp": 74,
    "SpFact": 9,
    "Channel": "LC254",
    "Lrrid": "08050376",
    "DeliveryStatus": 1,
    "CustomerData": {
      "name": "My Demo Device"
    },
    "Frequency": 869.525
  }
}

Output (ChirpStack v4 format)

{
  "devEUI": "IGNfAWEAACI=",
  "deviceName": "My Demo Device",
  "acknowledged": true,
  "txInfo": {
    "frequency": 869525000,
    "modulation": "LORA",
    "loRaModulationInfo": {
      "spreadingFactor": 9
    }
  }
}

Notification Device Status message

Input (Actility format)

{
  "DevEUI_notification": {
    "Time": "2023-02-22T17:14:02.000+00:00",
    "DevEUI": "0018B20000000B20",
    "DevAddr": "05CB0AE8",
    "FCntDn": 0,
    "Type": "devstatusans",
    "Var1": "98",
    "Var2": "8"
  }
}

Output (ChirpStack v4 format)

{
  "devEUI": "ABiyAAAACyA=",
  "batteryLevel": 98,
  "batteryLevelUnavailable": false,
  "margin": 8
}